home *** CD-ROM | disk | FTP | other *** search
/ TOS Silver 2000 / TOS Silver 2000.iso / Spiele / GEMSPIEL / COLTRIS / DOC / LIESMICH.TXT < prev    next >
Encoding:
Text File  |  1995-04-21  |  11.5 KB  |  273 lines
  1. WinColTris  V2.0  27.12.1994
  2.             V2.2   5. 4.1995
  3.  
  4. yet another COLUMNS and TETRIS version
  5. (noch so eine COLUMNS und TETRIS Version)
  6.  
  7. geschrieben von Th. Morus Walter
  8. (c) 1994/95 by Never Ready Software, Morus Walter
  9.  
  10. Dieses Programm war FREEWARE!
  11. Dieses Programm ist FAIRWARE!
  12.  
  13. Th. Morus Walter
  14. Frankenstraße 214
  15. 97078 Würzburg
  16. Kontonr.: 301116  Raiffeisenbank Rimpar-Versbach eG  BLZ 790 682 22
  17.  
  18.  - - - - -
  19.  
  20. WinColTris V2.0 ist ein Nachfolger von ColTris V1.0.
  21. Nachdem es bereits ein (Tetris)-Programm namens ColTris gibt, habe ich
  22. ColTris umbenannt, wobei das Win für Window (nicht Windows, schon
  23. gar nicht MS-Windows) steht. Wenn im folgdenden dennoch meist von COLTRIS
  24. die Rede ist, so liegt das daran, daß ich beim Überarbeiten der Anleitung
  25. nicht alles geändert habe.
  26.  
  27. Während ich bei V1.0 Fenster noch für zu aufwendig und überflüssig hielt
  28. habe ich mich jetzt doch zu solchen entschieden.
  29. Weitere Neuerung ist die Lauffähigkeit in Farbauflösungen, wenn auch
  30. etwas langsamer als in monochrom, da vollständig auf das (N)VDI angewiesen.
  31. Allerdings läuft das ganze selbst auf meinem uralten ST trotzdem noch mit 
  32. brauchbarer Geschwindigkeit (mit NVDI).
  33.  
  34. Vorwort zu V1.0 (Auszüge)
  35. -------------------------
  36. Noch so'ne COLUMNS und TETRIS Version - warum?
  37.  
  38. Es gibt bereits jede Menge Columns und Tetris Versionen, also warum noch
  39. eine? Bisher habe ich die Programme COLUMNS und STETRIS von PCM van
  40. der Arend verwendet, die ich mir gut gefielen. Leider laufen sie nicht
  41. unter MagiX, insbesondere nicht bei Verwendung von AutoswitchOverscan.
  42. Also brauchte ich eine Alternative und konnte keine finden die mir gefiel -
  43. trotz der Vielzahl an Versionen.
  44. Deshalb schrieb ich mein eigenes Programm, wobei die genannten Progamme
  45. von PCM van der Arends als Vorbilder dienten.
  46.  
  47. Verglichen mit den Vorbildern fehlen einige Möglichkeiten in COLTRIS,
  48. andererseits hat man einige Vorteile.
  49.  
  50.  - - - - -
  51.  
  52. COLTRIS sollte auf jedem ST/TT/Falcon laufen.
  53.  
  54. COLTRIS unterstützt im Prinzip jede Auflösung ab 320x200 Punkten
  55. und bis zu 256 Farben (High/True Color wurde nicht berücksichtigt).
  56. Monochrome Auflösungen werden durch spezielle Assemblerroutinen
  57. unterstützt, bei Farbe wird ausschließlich das VDI verwendet.
  58. WinColTris enthält Spielsteine nur für monochrome Auflösung in einer
  59. festgelegten Größe. WinColTris kann aber Spielsteine beliebiger Größe
  60. nachladen, was in Farbe zwingend ist. Die Spielsteine müssen die
  61. gleiche Farbtiefe haben wie der Bildschirm.
  62. Es liegen Spielsteine für 4 und 16 Farben, die für ST-mid und ST-low
  63. gedacht sind bei (vgl. Abschnitt Spielsteine); diese sind aber eher
  64. als Beispiel für Spielstein-Dateien gedacht, weil ich erstens
  65. nicht in Farbe spiele, zweitens kein brauchbares Graphikprogramm
  66. besitze und drittens der Meinung bin, auch User können mal was tun.
  67.  
  68. COLTRIS läuft unter MagiX (schätzungsweise auch unter MultiTOS, aber
  69. das konnte ich nicht testen), optional kann man im Multitasking-Modus
  70. spielen, ohne daß der Bildschirm während des Spielens gesperrt wird.
  71.  
  72.  - - - - -
  73.  
  74. Ich gehe davon aus, daß jeder Columns und Tetris kennt. Ich werde die
  75. Spiele also nicht erklären.
  76.  
  77.  - - - - -
  78.  
  79. COLTRIS V2.0 kann anders als V1.0 nur als Programm laufen, da es eine
  80. Menüleiste besitzt. Accessorybetrieb ist nicht mehr möglich.
  81.  
  82. WinColTris verwendet bis zu vier Fenster, für das Spielfeld, die Punktanzeige,
  83. den Preview und die Statistik.
  84.  
  85. Nach dem Start des Programmes wird das Spielfeld, eventuell weiter Fenster
  86. und die Menüleiste angezeigt.
  87.  
  88. Folgende Menüpunkte sind vorhanden:
  89.  
  90. Menü 'WinColTris' Menüpunkt 'about WinColTris':
  91. na was wohl, der Autor feiert sich selbst...
  92.  
  93. Menü 'File':
  94.   Menüpunkt 'Play'
  95.     Hmm, was kann das wohl sein.
  96.     Erreicht man bei einem Spiel einen neuen Hiscore, so wird man aufgefordert
  97.     den Namen einzugeben...
  98.   Menüpunkt 'Hiscore'
  99.     Zeige den Hiscore des eingestellten Spieles an
  100.     Ist das zuletzt erspielte Ergebnis im Hiscore vorhanden, so wird es
  101.     durch einen '*' markriert.
  102.   Menüpunkt 'Save'
  103.     Speichere Hiscore UND Optionen
  104.     Der Hiscore wird nicht automatisch gespeichert.
  105.     Mit den Optionen werden auch die Fensterpostionen gespeichert und
  106.     zwar für bis zu 8 Auflösungen getrennt.
  107.   Menüpunkt 'Quit'
  108.     lets go home... 
  109.  
  110. Menü: 'Options':
  111.   Menüpunkt 'Tetris'
  112.     Spielmodus auf Tetris einstellen
  113.   Menüpunkt 'Columns'
  114.     Spielmodus auf Columns einstellen
  115.    beim Ändern des Spielmodus wird das Spielfeld angepaßt und die anderen
  116.    Fenster entsprechend der Voreinstellung für das Spiel angezeigt, d.h.
  117.    man kann den Preview für Tetris ein- und Columns ausschalten...
  118.   Menüpunkt 'Score'
  119.    Anzeige der Wertung ein/aus (wird durch Haken angezeigt)
  120.   Menüpunkt 'Preview'
  121.    Anzeige der Voranzeige ein/aus (wird durch Haken angezeigt)
  122.   Menüpunkt 'Statistic'
  123.    Anzeige der Statistik ein/aus (wird durch Haken angezeigt)
  124.   Menüpunkt 'Options'
  125.     Optionen einstellen 
  126.     Die Optionen sind teilweise für Columns und Tetris getrennt, man erhält 
  127.     die Optionen für Tetris, wenn 'Tetris' eingestellt ist, und die für 
  128.     'Columns', wenn 'Columns' selektiert ist (jeweils zusammen mit den 
  129.     gemeinsamen Optionen).
  130.     Als erstes kann man den Start-Level des Spieles festlegen. Es folgt die
  131.     Möglichkeit, die Höhe einer zufälligen Vorbelegung des Spielfeldes
  132.     einzustellen.
  133.     Die weiteren Optionen sind gemeinsam.
  134.     COLTRIS hat zwei Graphik-Modi. Wenn der Bildschirmaufbau vergleichbar
  135.     mit ST-hoch ist (nur der Aufbau der Bitmap, die Größe muß nicht 640x400
  136.     sein) sollte man 'ST' verwenden. Dann werden die Blöcke direkt in den
  137.     Bildschirmspeicher kopiert. Die Bildschirmbreite wird mittels der LineA
  138.     Variablen ermittelt, die Bildschirmadresse mit Logbase() (COLTRIS verwendet
  139.     ansonsten KEIN LineA).
  140.     Andernfalls muß man 'VDI' verwenden. Die Blöcke werden dann via VDI
  141.     auf den Bildschirm kopiert. Das VDI ist natürlich langsamer als meine
  142.     (hochspezialisierten) Assembler-Routinen, Flackern kann es aber nicht,
  143.     da ein Puffer verwendet wird.
  144.     In Farbauflösungen wird immer das VDI verwendet.
  145.     Als nächstes kann man den Spielmodus wählen: im Modus 'single' reißt
  146.     WinColTris die Kontrolle über Bildschirm und Maus an sich, es sind keine
  147.     Fensteroperationen usw. möglich, andere Programme (in Multitasking) können
  148.     keine Ausgaben machen (in diesem Zusammenhang gibt es ein kleines Problem
  149.     mit dem ein- und ausschalten von Anzeigen während des Spielens (s.u.).
  150.     Schaltet man ein Fenster aus und liegt dies auf einem Fenster eines anderen
  151.     Programmes, so kann dieses andere Programm den nötigen Fensterredraw
  152.     nicht durchführen und das Fenster bleibt scheinbar offen. Der Screenmanager
  153.     kann merkwürdigerweise neuzeichnen, so daß das Problem eigentlich nur
  154.     unter Multitasking auftritt...).
  155.     Im Modus 'multi' wird lediglich das Spielfeld-Fenster (und eventuell
  156.     die anderen Fenster von WinColTris) getopped (also nach vorne gebracht).
  157.     Die Maus- und Bildschirmkontrolle bleibt beim TOS, andere Programme
  158.     können Ausgaben machen usw. Dieser Modus ist deutlich langsamer, da
  159.     vor jeder Ausgabe das Fenster überprüft werden muß, der Mauszeiger
  160.     ein- und ausgeschaltet wird usw. Die Menüpunkte von WinColTris
  161.     lassen sich in diesem Modus teilweise aufrufen, nicht allerdings
  162.     die ShortCuts, er werden auch keine Eingaben via AV/VA Send-Key
  163.     an den Desktop verschickt (auch nicht Ctrl-W zum Fenstercyclen)
  164.     ACHTUNG! Anders als die Namensgebung dies vermuten läßt ist es nicht
  165.     so, daß man unter Single-Tos 'single' und unter Multi-Tos (MagiC...)
  166.     'multi' verwenden muß. Beide Modi sind unter beiden OS-Varianten
  167.     möglich...
  168.     Der AV/VA Modus ist unter Multi-Tasking interessant, wenn man einen
  169.     intelligenten Desktop wie Gemini (oder meinetwegen auch EASE) verwendet.
  170.     Hier wird eingestellt, welche Fenster WinColTris beim Desktop (eben
  171.     über das AV/VA-Protokoll) anmelden soll, damit sie am programmübergreifenden
  172.     Fensterwechsel mittels Ctrl-W teilnehmen (es gibt in WinColTris allerdings
  173.     keinen Menüpunkt dafür). Möglich ist kein Fenster, nur das Spielfeld
  174.     oder alle Fenster.
  175.     Mit dem letzten Button kann man Einstellen, ob vor Spielbeginn alle
  176.     Fenster (Button selektiert) oder nur das Spielfeld nach vorne gebracht
  177.     werden sollen.
  178.     Topped man bei Spielbeginn alle Fenster, so kann man sich beim Cyclen
  179.     auf das Spielfeld beschränken, und es nehmen nicht so viele Fenster
  180.     daran teil...
  181.  
  182.     Die letzte Option, die man wählen kann, sind die benutzer-definierten
  183.     Tasten. Man kann zusätzliche Tasten  für die Grundfunktionen (Stein nach
  184.     links, Stein nach rechts, rotiere Stein und lasse Stein fallen) einstellen.
  185.  
  186.  - - - - -
  187.  
  188. Shortcuts:
  189. Zusätzlich zu den im Menü angezeigten Tastaturshortcuts hat man die folgenden
  190. Möglichkeiten:
  191.  
  192. Alle Tastenkombinationen außer 'Ctrl S' und 'Ctrl Q' können auch ohne
  193. Ctrl gedrückt werden.
  194. 'return' und 'enter' starten das Spiel.
  195.  
  196.  - - - - -
  197.   
  198. Wärend des Spiels hat man die folgenden Tastaturkomandos:
  199.  
  200. 7#     Stein nach links
  201. 9#     Stein nach rechts
  202. 8#     Stein rotieren
  203. 4#     Stein fallen lassen
  204. space  Stein fallen lassen
  205. q      Spiel beenden
  206. esc    Spiel beenden
  207. s      Spiel stoppen (weiter mit irgendeiner Taste)
  208. l      Level erhöhen
  209. *#     Level erhöhen
  210. n      Preview umschalten
  211. b      Statistik umschalten
  212. i       Wertung umschalten
  213.  
  214. Der Hash (#) markiert Tasten auf dem Ziffernblock (COLTRIS verwendet
  215. Scancodes)
  216. Benutzerdefinierete Tasten werden zuerst ausgewertet, sie können also
  217. vordefinierte Tasten überschreiben 
  218.  
  219. Beim Ändern der Anzeige eines Hilfsfensters ist zu bemerken, daß nach Spielende
  220. dessen Zustand wiederhergestellt wird.
  221.  
  222.  - - - - -
  223.  
  224. Spielsteine: 
  225.  
  226. WinColTris wurde ursprünglich für den rein monochromen Betrieb konzipiert. 
  227. Nur für diesen Fall sind im Programm auch Spielsteine integriert.
  228. In allen anderen Fällen (also ab 4 Farben) werden die Spielsteine aus
  229. IMG-Dateien geladen (OHNE Farbtabelle). Dies ist auch in monochrom
  230. möglich, allerdings nicht unbedingt ratsam, da dann die schnellen 
  231. Kopierroutinen nicht mehr genutzt werden können, sondern das (N)VDI
  232. bemüht werden muß.
  233.  
  234. Die IMG-Dateien müssen den Namen COLUMNSx.IMG und TETRISx.IMG haben,
  235. wobei das x für die Zahl der Planes (4 Farben -> 2 Planes, 
  236. 16 Farben -> 4 Planes, 256 Farben -> 8 Planes, True/HiColor nicht möglich!)
  237. steht. Die Dateien sind für Columns und Tetris getrennt, natürlich kann
  238. man zweimal die gleiche Datei verwenden (man beachte aber, daß das Tetris
  239. Spielfeld 10x20, das Columns Spielfeld nur 6x16 Steine groß ist).
  240.  
  241. Die Spielsteine können beliebige Größe haben. Es wird nicht geprüft, ob
  242. das Spielfeld bei der Größe der Steine noch ganz auf den Bildschirm 
  243. paßt, gegebenenfalls muß man halt blind Spielen.
  244.  
  245. Die IMG-Dateien haben den folgenden Aufbau:
  246.  
  247. Eine Zeile mit 16 Steinen, wobei
  248. der erste leer ist (wird zum Löschen verwendet),
  249. der zweite bis achte die Steine in den verschiedenen 'Farben' sind
  250.   (in Columns bleibt der letzte unbenutzt)
  251. der neunte bis dreizehnte in Folge vor dem Entfernen von Steinen angezeigt wird
  252. die restlichen drei Steine nicht verwendet werden (sie müssen aber da sein,
  253.   sonst wird die Stein-Breite falsch berechnet).
  254.  
  255. Die Steine müssen nicht quadratisch sein, es müssen lediglich alle
  256. Steine gleichbreit sein.
  257. Die Farbtabelle einer XIMG-Datei wird ignoriert.
  258.  
  259. Die beiliegenden Beispiele (für Columns und Tetris gleich) sind weniger
  260. zum Spielen, denn als Beispiel für eigene Steine gedacht.
  261. Sie sind nämlich höchst häßlich... (ich spiel halt nur in monochrom)
  262. Die Größe der Beispiele ist an der geringen und mittleren ST-Auflösung
  263. orientiert.
  264.  
  265.  - - - - -
  266.  
  267. bekannte Fehler (nicht alles ist wirklich ein Fehler)
  268.  
  269. beim Lesen und Schreiben der Optionsdatei COLTRIS.SET findet praktisch
  270. KEINE Fehlerbehandlung statt.
  271.  
  272.  
  273.